home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-03 / debut141.zip / SD.DOC < prev    next >
Text File  |  1990-07-29  |  35KB  |  873 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.                       S C R E E N   D E B U T  v1.41
  28.  
  29.                          by Willie Robinson
  30.                          2613 Louis Blvd
  31.                          Hephzibah Ga 30815
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.         (C)opyright 1990 Willie Robinson
  49.  
  50.                   S  C  R  E  E N    D  E  B  U  T      1.41    Pg 1
  51.     ─────────────────────────────────────────────────────────────────
  52.  
  53.  
  54.  
  55.                                  Contents
  56.  
  57.  
  58.  
  59.      Foreword...............................................Page 2
  60.  
  61.      Disclaimer.............................................Page 2
  62.  
  63.      Shareware Notice.......................................Page 3
  64.  
  65.      Starting Screen Debut..................................Page 4
  66.  
  67.      General Editing Commands...............................Page 4
  68.  
  69.      Editing Commands.......................................Page 5
  70.  
  71.      ANSI Animation Mode....................................Page 10
  72.  
  73.      ANSI System............................................Page 11
  74.  
  75.      Support for GT Power BBSs..............................Page 12
  76.  
  77.      Hammerly's ProBas......................................Page 13
  78.  
  79.      File Handling..........................................Page 14
  80.  
  81.      Block Diagram of Major Functions.......................Page 15
  82.  
  83.      Snap Screen............................................Page 16
  84.  
  85.      Odds and Ends..........................................Page 17
  86.  
  87.      Limitations............................................Page 18
  88.  
  89.                    S  C  R  E  E N    D  E  B  U  T      1.41    Pg 2
  90.     ─────────────────────────────────────────────────────────────────
  91.  
  92.  
  93.                              THANK-YOU
  94.  
  95.  
  96.      Thank-you to all the people who have contributed so greatly to
  97.     the success of this program. Without your support and suggestions
  98.     this program would not have achieved the level of performance that
  99.     it currently maintains.
  100.  
  101.     A personal thank-you to:
  102.  
  103.     Perry Alexander                      Steve Moody
  104.     Scott Cushman                        Steve Paye
  105.     Tom & Jane Devlin                    David Philpott
  106.     Jack Hazel
  107.     Chris Kitchin
  108.     Warren Leadbeatter
  109.     
  110.  
  111.  
  112.                               FOREWORD
  113.  
  114.      Screen Debut is a very powerful screen generator. It's designed as
  115.     a tool to ease the development of text screens. It generates code
  116.     for screens in many different ways.
  117.  
  118.  
  119.     »   ASCII Code
  120.  
  121.  
  122.     »   ANSI Code for use with DOS and Telecommunications.
  123.  
  124.  
  125.     »   BASIC Code with & without line numbers plus BSAVE.
  126.  
  127.  
  128.     »   C Code for Turbo C.
  129.  
  130.  
  131.     »   Pascal Code For use with Turbo Pascal.
  132.  
  133.  
  134.     »   Compressed Binary Format for use with Snap Screen
  135.         and Hammerly's ProBas.
  136.  
  137.  
  138.  
  139.     DISCLAIMER: While this program has been extensively tested,
  140.     unforeseen snags may arise. The use of this program is at your
  141.     own risk!
  142.  
  143.                    S  C  R  E  E N    D  E  B  U  T      1.41    Pg 3
  144.     ─────────────────────────────────────────────────────────────────
  145.  
  146.  
  147.  
  148.                              SHAREWARE NOTICE
  149.  
  150.  
  151.  
  152.     This program is a shareware program, feel free to share it with
  153.    your friends. The more you share it, the wider it's distribution
  154.    will be. Please help by uploading it to all BBSs!
  155.  
  156.     Under the shareware concept, the user is allowed to try out the
  157.    program before purchasing it. If you like the program and feel it
  158.    will be of use to you, please register it by sending $10.00 to the
  159.    address below. With a $10.00 registration you will receive a free
  160.    complimentary copy of Screen Predator (Outside US add $10.00 for
  161.    handling plus postage) and the most recent version of Screen Debut.
  162.  
  163.     If you do use the program, help it along with your registration fee.
  164.    Your support will help to keep the program alive. Send registrations
  165.    to the address below. Please specify 3.5 or 5.25 inch disk. Outside
  166.    North America add $10.00 for handling and postage.
  167.  
  168.  
  169.  
  170.                             Willie Robinson
  171.                             2613 LOUIS BLVD
  172.                             HEPHZIBAH GA. 30815
  173.  
  174.  
  175.  
  176.  
  177.    NOTICE: This program is Copyrighted.  ALL Rights Reserved.  It may
  178.   not be modified, disassembled, or sold by second parties without
  179.   written consent from the author. Site license information is available.
  180.  
  181.  
  182.   NOTE TO SHAREWARE DISTRIBUTION OUTLETS: A small fee (Less Than $10.00)
  183.   may be charged for copying and providing a disk. This does not negate
  184.   the authors request.
  185.  
  186.  
  187.   NOTE TO SYSOPS: Thank-you for your support of this program!
  188.  
  189.                     S  C  R  E  E N    D  E  B  U  T      1.4     Pg 4
  190.    ──────────────────────────────────────────────────────────────────
  191.  
  192.  
  193.                           STARTING SCREEN DEBUT
  194.  
  195.    From the Dos Prompt:
  196.  
  197.        A>SD YOURFILE  (Screens can be loaded from the command line)
  198.  
  199.    Command Line Switches:
  200.  
  201.       /S - Puts the program in Snow Suppression mode. This is only
  202.       useful for older CGA chips. If you don't see snow, don't use
  203.       this switch. It slows the program down.
  204.  
  205.  
  206.  
  207.                           GENERAL EDITING COMMANDS
  208.  
  209.   »  Screen Debut is Mouse supported. All commands use the left button.
  210.  
  211.   »  The Arrow Keys move the cursor on the screen. The status bar at
  212.      the bottom of the screen indicates the cursor's coordinates. To
  213.      draw lines, use the F2 Key to toggle between Move Cursor, Single
  214.      Border, and Double Border.
  215.  
  216.   »  The Home, End, Pg Up, Pg Dn, and Tab also move the Cursor on the
  217.      screen.
  218.  
  219.   »  The Back Space key removes character to the left of the Cursor and
  220.      moves the Cursor one space to the left. Pulling all Characters to
  221.      the right of the cursor one space to the left.
  222.  
  223.   »  Pressing the "Ins" key will toggle between the insert mode and the
  224.      overwrite mode of operation. In the Insert mode the cursor is small.
  225.      This allows characters to be inserted. In the Overwrite mode the
  226.      cursor is full height. This allows characters to be overwritten.
  227.  
  228.   »  The Del key removes characters.
  229.  
  230.   »  The "`" key is user definable via the ASCII chart. [Alt] I
  231.  
  232.   »  Full Control key support. [Ctrl] A place ASCII character #1 (a happy
  233.      face) at the cursor and so on.
  234.  
  235.   »  Full Numeric ASCII code support. Hold down the [ALT] key and type
  236.      the ASCII code into the NUMERIC key pad. The Character will be
  237.      placed at the cursor position.
  238.   
  239.                      S  C  R  E  E N    D  E  B  U  T      1.4     Pg 5
  240.    ──────────────────────────────────────────────────────────────────
  241.  
  242.                              Editing Commands
  243.  
  244. The Help screen displays all commands available. These commands are
  245. available from the screen editing environment. This is a sample of the
  246. help screen while in the Non-animated mode.
  247.  
  248. ╔═══════════════════════════════════════════════════════════════════════╗
  249. ║                              HELP  SCREEN                             ║
  250. ║ ──────────────────────────────────┬────────────────────────────────── ║
  251. ║  Toggle Line mode w/  [Alt] Z  F1 │  Wipe        Screen     [Alt] W   ║
  252. ║  Toggle Line mode w/o [Alt] Y  F2 │  Free        Memory     [Alt] =   ║
  253. ║ ──────────────────────────────────┼────────────────────────────────── ║
  254. ║  Change      Color      [Alt] C   │  Load        Screen     [Alt] L   ║
  255. ║  Grab        Color      [Alt] G   │  Load        File       [Alt] F   ║
  256. ║  Recolor     Color      [Alt] R   │  Save        Screen     [Alt] S   ║
  257. ║  Recolor     Area       [Alt] A   │  Change      Directory  [Alt] D   ║
  258. ║ ──────────────────────────────────┼────────────────────────────────── ║
  259. ║  Move        Area       [Alt] M   │  ANSI        Code       [Alt] 1   ║
  260. ║  Copy & Move Area       [Alt] &   │  BASIC       Code       [Alt] 2   ║
  261. ║  Paste       Area       [Alt] P   │  C           Code       [Alt] 3   ║
  262. ║  Cut         Area       [Alt] -   │  Pascal      Code       [Alt] 4   ║
  263. ║  Copy        Area       [Alt] K   │  ASCII                  [Alt] 5   ║
  264. ║ ──────────────────────────────────┼────────────────────────────────── ║
  265. ║  Big         Fonts      [Alt] B   │  Animation   On/Off     [Alt] O   ║
  266. ║  ASCII       Chart      [Alt] I   │                                   ║
  267. ║  Line        Unions     [Alt] U   │                                   ║
  268. ║ ──────────────────────────────────┼────────────────────────────────── ║
  269. ║  Jump   to   Shell      [Alt] J   │                                   ║
  270. ║  Exit        Program    [Alt] X   │                                   ║
  271. ╚═══════════════════════════════════════════════════════════════════════╝
  272.  
  273. [Alt] H  This key activates the Help screen.
  274.  
  275. [Alt] T  Or F1  toggles between Move Cursor, Single Border, and  Double
  276.          Border. This is useful for moving the cursor and drawing  single
  277.          or double lines. This function automatically places line
  278.          junctions.
  279.  
  280. [Alt] Y  Or F2. The same as [Alt] T above without auto junctions.
  281.  
  282.  
  283. [Alt] C  Change Color. Sets the current color attributes. The current
  284.          color is indicated by the color of the left half of the Status
  285.          Line.
  286.  
  287. [Alt] G  Grab color. Sets the current color attributes of the program
  288.          by grabbing the color that exists under the cursor.
  289.  
  290.                     S  C  R  E  E N    D  E  B  U  T      1.41    Pg 6
  291.    ──────────────────────────────────────────────────────────────────
  292.  
  293. [Alt] R  Reset Color - Resets a color on the screen. Place the cursor
  294.          over the color you wish to reset. Notice that the red selector
  295.          arrow visually differentiates this function from the Change Color
  296.          function (  ≡> versus >  ).
  297.  
  298. [Alt] A  Color Area - Recolors a Block (a square) on the  screen.
  299.          Note: The Block is Re-colored to the current selected color.
  300.  
  301. [Alt] M  Move Area - Place the cursor on a corner of the block to be
  302.          moved before entering this command. The block selected may be
  303.          of any size.
  304.  
  305. [Alt] &  Copy & Move Area. This function allows a block to be copied
  306.          from one position to another.
  307.  
  308. [Alt] P  Paste - Restores a block which was saved with the  Cut or
  309.          Copy function.
  310.  
  311. [Alt] -  Cut -  Cuts a block from the screen, storing it in memory
  312.          for later recovery with Paste. Cut is also useful for
  313.          erasing all or part of the Screen. The cut area assumes
  314.          the current color attributes.
  315.  
  316. [Alt] K  Copy - This function works much like a camera. It copies a
  317.          selected area into memory, saving it for later recovery
  318.          with Paste. The main purpose of the Cut, Copy, and Paste
  319.          functions is to allow the importation of screen snapshots.
  320.  
  321. [Alt] B  Big Fonts - Allows BIG LETTERS to be placed on the screen.
  322.          All ASCII characters from 1 to 127 are supported. The
  323.          Pointer on the ASCII Chart ([Alt] I) is used to select the
  324.          fill characters. To use the ASCII Chart without putting a
  325.          character at the current cursor position set the pointer
  326.          and press Escape. The fill characters may be of any ASCII
  327.          character. The Letters will be of the programs color setting.
  328.          The Tab Key works very well for letter spacing. The
  329.          characters are based on a 8 x 8 Row/Column matrix. There are
  330.          three methods to enter the BIG character.
  331.  
  332.          1) The normal keyboard keys.
  333.  
  334.          2) Use the [Ctrl] letter combination that represents a
  335.             control character. (ASCII codes 1 to 30)
  336.  
  337.                     S  C  R  E  E N    D  E  B  U  T      1.41    Pg 7
  338.    ──────────────────────────────────────────────────────────────────
  339.  
  340.          3) Hold down the [ALT] Key and type in the ASCII character
  341.             number.
  342.             Note: This is a tough way to go, but if you don't have a
  343.             book with an ASCII chart then use the programs chart
  344.             ([Alt] I). Start at the top and count from left to right.
  345.             The first character is number #1 or [Ctrl] A depending
  346.             how you look at it.
  347.  
  348. [Alt] I  ASCII Chart - Characters not supported by the Keyboard are
  349.          available on the ASCII chart. The selected character will be
  350.          placed at the cursors current location.
  351.          The pointer on the chart also defines the "`" key and fill
  352.          characters for the Big Font operation.
  353.  
  354.          Caution: Some ASCII characters, control codes, cause
  355.          unpredictable results when used in conjunction with programming
  356.          languages.
  357.  
  358. [Alt] U  The F6 key selects Box Junctions.
  359.  
  360. [Alt] J  Jump to the DOS shell - The "[Alt] J" key exits to the DOS
  361.          shell. This means the program stays in the computer's memory
  362.          while work is being done at the DOS level.
  363.          Note: Set the DOS Path so COMMAND.COM can be found. As an
  364.          alternative, place COMMAND.COM in the current directory.
  365.  
  366. [Alt] X  Exit the program
  367.  
  368. [Alt] W  Wipe Screen - Clears the current screen and animation buffer.
  369.          to a grey foreground on a black background. Use the Recolor
  370.          function to change the foreground and background colors if
  371.          desired.
  372.  
  373. [Alt] =  Free Memory - Displays the amount of free memory left in the
  374.          computer.
  375.  
  376. [Alt] L  Load Screen - Loads Screen Debut compressed binary files.
  377.          These files have the ".SD" and ".SDA" extension.
  378.  
  379. [Alt] F  Load File - Loads raw files. Screen Debut directs these files
  380.          through the BIOS, therefore the ANSI Device Driver must be
  381.          installed.  Files are loaded in line by line. Hit any key
  382.          to stop the loading process.
  383.  
  384. [Alt] S  Save Screen -  The "[Alt] S" key saves the screen in Screen
  385.          Debut's compressed binary format .
  386.          Caution: Do not keep more than 110 .SD files in one DOS
  387.          directory. Use sub-directories to surpase this limitation.
  388.  
  389. [Alt] D  Change Directory
  390.  
  391.                     S  C  R  E  E N    D  E  B  U  T      1.41    Pg 8
  392.    ──────────────────────────────────────────────────────────────────
  393.  
  394. [Alt] 1  ANSI Code - Screen Debut use three separate algorithms to
  395.          code  ANSI screens. The first two code the Static
  396.          (Non-Animated) Screen. It uses Auto-Sizing to adjust the size of
  397.          the coded screen. Auto Sizing first determines the existence and
  398.          size of the drawing by scanning the screen from bottom (Row 24)
  399.          to top. Then it scans from right to left to determine the right
  400.          edge of the drawing. It does this by searching for characters
  401.          that are not blank spaces (ASCII character 32) of the default
  402.          color white on black. Once it has determined that a drawing does
  403.          exist on the screen and it's size, it codes it. See the section
  404.          on "Support for GT power BBSs" for a discussion on the code
  405.          parameter window.
  406.  
  407.           The Third algorithm codes the Soft (Animated) Screen. It
  408.          first checks to see if an animated drawing exists. If there
  409.          is anything in the animation buffer (memory area) it codes
  410.          it. The code produced here is sensitive to screen placement.
  411.          It uses the screens Row and Column coordinates to place each
  412.          character. Furthermore, the cursors resting position
  413.          (position of the cursor when the ALT A command was used)
  414.          will be recorded into the ANSI code.
  415.  
  416. [Alt] 2  BASIC Code -  Screen Debut codes the top 24 rows of the
  417.          screen in Basic, with or   without line numbers. Use
  418.          Basic's "MERGE" command to place the   code built by Debut
  419.          into your program.  Basic screen files end with the .BAS
  420.          extension. Use Basic's "RENUM" command to renumber the line
  421.          numbers if needed.
  422.  
  423.                                 BSAVE
  424.  
  425.          Load BSAVE files from Basic with the use of the "BLOAD"
  426.          command. An example has been provided in the file "BLOAD.BAS".
  427.          Note: The BSAVE files made by this program haven't been
  428.          successful on Tandy computers. (?)
  429.  
  430. [Alt] 3  C Code - The C code is built from the top 24 rows of the screen.
  431.          The code is compatible with Turbo C. C screen files end with the
  432.          ".C" extension.
  433.  
  434. [Alt] 4 Pascal Code - Originally Screen Debut was built as a Pascal
  435.         screen code generator. The Pascal code generated by it is
  436.         compatible with Turbo Pascal. Due to the use of the "CheckSnow"
  437.          variable the screens are very fast. The code can be produced
  438.          as either a procedure or as a unit. See your Language manual
  439.          to include the screens into your program. Pascal coded screens
  440.          end with the extension ".PAS".
  441.  
  442. [Alt] 5 ASCII - Turns the screen into ASCII text.
  443.  
  444.                     S  C  R  E  E N    D  E  B  U  T      1.41    Pg 9
  445.    ──────────────────────────────────────────────────────────────────
  446.  
  447. [Alt] O Animation On/Off - Screen Debut allows for Animated and Non-
  448.         Animated ANSI screens. To enter or exit the ANSI Animation mode
  449.         of operation press the "[Alt] O" key. Once you have pressed it
  450.         you will notice a change at the bottom status line of the
  451.         screen. In the Animation Mode of operation, a frame counter will
  452.         appear on the Statue Line.
  453.          For information on Animation mode see the section on Animation
  454.         editing commands. A small blinking box on the right of the
  455.         status line indicates the screen is Animated.
  456.  
  457.         Note: Some of the editing commands available in the non-animation
  458.         Mode are not available in animation mode.
  459.  
  460.                      S  C  R  E  E N    D  E  B  U  T      1.41    Pg 10
  461.    ──────────────────────────────────────────────────────────────────
  462.  
  463.                          ANSI Animation Mode commands
  464.  
  465. The editing functions available are listed on the Help screen. Many of
  466. the commands listed here duplicate the editing commands while in the
  467. non-animation mode. Listed after the menu are the commands that deviate
  468. in operation when in the non-animated mode.
  469.  
  470.  
  471. ╔═══════════════════════════════════════════════════════════════════════╗
  472. ║ Animator Menu                HELP  SCREEN                             ║
  473. ║ ──────────────────────────────────┬────────────────────────────────── ║
  474. ║  Toggle Line mode w/  [Alt] T  F1 │  Wipe        Screen     [Alt] W   ║
  475. ║  Toggle Line mode w/o [Alt] Y  F2 │  Free        Memory     [Alt] =   ║
  476. ║ ──────────────────────────────────┼────────────────────────────────── ║
  477. ║  Change      Color      [Alt] C   │                                   ║
  478. ║  Grab        Color      [Alt] G   │                                   ║
  479. ║                                   │                                   ║
  480. ║                                   │                                   ║
  481. ║ ──────────────────────────────────┼────────────────────────────────── ║
  482. ║                                   │                                   ║
  483. ║                                   │                                   ║
  484. ║                                   │                                   ║
  485. ║                                   │                                   ║
  486. ║  Copy        Area       [Alt] K   │                                   ║
  487. ║ ──────────────────────────────────┼────────────────────────────────── ║
  488. ║                                   │  Animation   On/Off     [Alt] O   ║
  489. ║  ASCII       Chart      [Alt] I   │  Step        Forward    [Alt] 0   ║
  490. ║  Line        Unions     [Alt] U   │  Step        Back       [Alt] 9   ║
  491. ║ ──────────────────────────────────┼────────────────────────────────── ║
  492. ║  Jump   to   Shell      [Alt] J   │  View        Data       [Alt] V   ║
  493. ║                                   │  Animation   Replay     [Alt] R   ║
  494. ╚═══════════════════════════════════════════════════════════════════════╝
  495.  
  496. [Alt] K  Copy - Copy a block from the non-animated screen into the
  497.          animation buffer.
  498.  
  499. [Alt] W  Wipe Screen - Clears the animated portion of the screen.
  500.  
  501. [Alt] 0  Step Forward - Steps the program one step forward.
  502.  
  503. [Alt] 9  Step Back - Steps the program one frame back.
  504.  
  505.                     S  C  R  E  E N    D  E  B  U  T      1.41    Pg 11
  506.    ──────────────────────────────────────────────────────────────────
  507.  
  508. [Alt] V  Selects the "Data View" Option. This option pulls up a window
  509.          that contains information contained within the animation frames.
  510.          The options available are:
  511.  
  512.           Up/Down Arrow - Scrolls data
  513.  
  514.           Left/Right Arrow - Sets Replay Delay time in micro-seconds.
  515.                              This is the Animation display delay.
  516.  
  517.           Ins - Depressing the insert key insert a +/- character into
  518.                 the frame selected by the red arrow.
  519.  
  520.           Del - Cuts the character selected by the red arrow.
  521.  
  522. [Alt] R   Animation Replay - The animator to reset to frame 1 then
  523.           it replays the animation. To stop the animator press any
  524.           key. Animation speed is set using the [Alt] V function.
  525.           See the instructions on the [Alt] V key for an explanation
  526.           on how this works.
  527.  
  528.  
  529.  
  530.  
  531.                               ANSI SYSTEM SET-UP
  532.  
  533.  
  534.    ANSI Screens use the ANSI.SYS file that comes with DOS. Make sure
  535.    your CONFIG.SYS file contains the following.
  536.  
  537.                           DEVICE = ANSI.SYS
  538.  
  539.     It should be in the root directory on the hard disk or on the boot
  540.     up disk. If it doesn't exist it can be created with a word
  541.     processor, or the DOS COPY CON command. (SEE YOUR DOS MANUAL).
  542.  
  543.     Now your ready to use the ANSI screens built by Screen Debut.
  544.     ANSI screens have the extension ".ANS". Use the DOS "TYPE" command
  545.     to post the screen to your monitor. Example:
  546.  
  547.                           A>TYPE YOURFILE.ANS
  548.  
  549.     NOTE: An alternative to the ANSI.SYS is to use Snap Screen.
  550.                    (See Snap Screen in the Index)
  551.  
  552.                     S  C  R  E  E N    D  E  B  U  T      1.4     Pg 12
  553.    ──────────────────────────────────────────────────────────────────
  554.  
  555.  
  556.                     SUPPORT FOR GT Power BBSs
  557.  
  558.     GT Power BBSs allow uploading of ANSI Code into the message areas
  559.     using the ASCII protocol for uploading. Screen Debut supports these
  560.     message areas in the following ways.
  561.  
  562.     This example of the ANSI code parameter window appears every time
  563.     the Build ANSI code procedure is invoked.
  564.  
  565.                 ╓─────────────────────────────────────────╖
  566.                 ║                                         ║
  567.                 ║  Code Style                    Compact  ║
  568.                 ║  Code Width ±                  72       ║
  569.                 ║  Clear Screen                  Yes      ║
  570.                 ║  BBS Control Code              ^E       ║
  571.                 ╟────────────────────┬────────────────────╢
  572.                 ║    Enter           │             Esc    ║
  573.                 ╙────────────────────┴────────────────────╜
  574.  
  575.     1) Code Style
  576.  
  577.       Code style selects the coding routine which will code the non-
  578.       animated screen. There are two flavors, Regular and Compact.
  579.       Regular code is special geared to scroll the screen as it appears.
  580.       Compact code on the other hand uses a different coding strategy. It
  581.       will minimize the number of lines of code. Ideal for fairly complex
  582.       screens which will be used in a BBS message base.
  583.  
  584.     2) Code Width
  585.  
  586.       Use a width of 72 for message base work otherwise open it up to
  587.       250. For fine tuning use the "+" or "-" keys. "Note that these widths
  588.       are only approximations". The actual code width may be wider under
  589.       some circumstances.
  590.  
  591.     3) Clear Screen
  592.  
  593.        Controls whether or not the code to clear the screen is to be
  594.        used.
  595.  
  596.     4) Control Code Support
  597.  
  598.       GT BBSs use the "^E" and "^R" characters to control the "More Y/n?".
  599.       The "More" prompt is not always desirable. To add a "^E" or "^R" to
  600.       the beginning of a file, set ANSI Code parameter window's "BBS
  601.       Control Code". A "^E" will give one "More Y/n?" then allow the file
  602.       to run uninterrupted . A "^R" will allow a file to run it's entire
  603.       length without a "More Y/n?"
  604.  
  605.                      S  C  R  E  E N    D  E  B  U  T      1.41    Pg 13
  606.    ──────────────────────────────────────────────────────────────────
  607.  
  608.  
  609.  
  610.               Screen Debut Files with HAMMERLY'S PROBAS
  611.  
  612.  
  613.  
  614.          The Compressed Binary files with the .SD file extension are
  615.          compatible with Hammerly's ProBas. Here's the code segment
  616.          needed to load and post the screens.
  617.  
  618.  
  619.          DIM SCR%(2000)               '--- Dimension Array
  620.          DIM CSCR%(2000)
  621.  
  622.          '-/OPEN SCREEN FILE TO BE READ IN FROM DISK/------------------
  623.          CALL FOPEN("YOURFILE.SD", 0, 0, HANDLE%, ECODE%)
  624.          IF ECODE% THEN PRINT "ERROR"
  625.  
  626.          '-/Get file size/---------------------------------------------
  627.          CALL FSIZE(HANDLE%, BYTES&)
  628.          BYTES% = CINT(BYTES&)        '--- Put Long integer into short
  629.  
  630.          '-/Read Data in file/-----------------------------------------
  631.          CSEG% = VARSEG(CSCR%(1))     '--- Set Pointers
  632.          COFS% = VARPTR(CSCR%(1))
  633.          CALL DFREAD(HANDLE%, CSEG%, COFS%, BYTES%, BYTESREAD%, ECODE%)
  634.          IF ECODE% THEN PRINT "ERROR"
  635.  
  636.          '-/Close File/------------------------------------------------
  637.          CALL FCLOSE(HANDLE%)
  638.  
  639.          '-/UnCrunch Screen Data(Decompress)/--------------------------
  640.          DSEG% = VARSEG(SCR%(1))     '--- Reset pointers
  641.          DOFS% = VARPTR(SCR%(1))
  642.          CSEG% = VARSEG(CSCR%(1))
  643.          COFS% = VARPTR(CSCR%(1))
  644.          CALL UNSCRUNCH(DSEG%, DOFS%, CSEG%, COFS%)
  645.  
  646.          '-/Put Data to the Screen/------------------------------------
  647.          DSEG% = VARSEG(SCR%(1))     '--- Reset Pointers
  648.          DOFS% = VARPTR(SCR%(1))
  649.          CALL DSCRREST(DSEG%, DOFS%, 0, SNOW%)
  650.  
  651.                      S  C  R  E  E N    D  E  B  U  T      1.4     Pg 14
  652.    ──────────────────────────────────────────────────────────────────
  653.  
  654.  
  655.                              File Handling
  656.  
  657.  
  658.  
  659.    When doing a "Load Screen" function ([Alt] L), Screen Debut looks for
  660.    the files with the ".SD" extension. When a file is selected from the
  661.    menu it checks to see if it is has an animated counterpart.  The
  662.    animated files are the files with the extension ".SDA". If one exists,
  663.    it loads it along with the ".SD" file. It is assumed that a ".SDA"
  664.    file will not exist without a ".SD" file. When saving a file from one
  665.    of the build code functions the ".SD" file, the ".SDA" file   (If
  666.    appropriate), and the code file are all saved. If the .SD file exists,
  667.    Screen Debut will challenge the user with "*.SD EXISTS OVERWRITE ?".
  668.    Select "No" to write the code to the disk without overwriting the
  669.    *.SD file. Hit Escape to abort the procedure entirely. Debut guards
  670.    the ".SD" files because they represent your work.  The coded screens
  671.    are of no concern to it, it will overwrite them without notification.
  672.  
  673.  
  674.  
  675.                              File Extensions
  676.  
  677.  
  678.  
  679.               .SD...........Debut's Compressed Binary File
  680.  
  681.               .SDA..........Debut's Animated Screens
  682.  
  683.               .ANS..........ANSI Coded Screens
  684.  
  685.               .ASC..........ASCII Files
  686.  
  687.               .BAS..........Basic Coded Screens & BSAVE
  688.  
  689.               .C............C Language Coded Screens
  690.  
  691.               .PAS..........Pascal Coded Screens
  692.  
  693.  
  694.    Screen Debut also has the ability to load raw text and ANSI files
  695.    directly. For proper ANSI support of the "Load File" ([Alt] F) function
  696.    the ANSI Driver must be installed.
  697.  
  698.                     S  C  R  E  E N    D  E  B  U  T      1.4     Pg 15
  699.    ──────────────────────────────────────────────────────────────────
  700.  
  701.  
  702.  
  703.  
  704.  
  705.                           Major Function Areas
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.          A>SD >──────────────────────┐
  715.                             ┌────────┴────────┐
  716.                             │ OPENING  SCREEN │
  717.                             └────────┬────────┘
  718.        ┌───────────┐       ┌─────────┴──────────┐       ┌─────────────┐
  719.        │           │       │                    │   ┌───┤ Build  ALT  │
  720.        │           │       │                    │   │   │ ASCII   5   │
  721.        │           │       │                    │   │   ├─────────────┤
  722.        │ A      A  │       │                    │   ├───┤ Build  ALT  │
  723.        │ N      N  │       │                    │   │   │ ANSI    1   │
  724.        │ S      I  │       │      Main          │   │   ├─────────────┤
  725.        │ I      M  ├───────┤      Editor        ├───┼───┤ Build  ALT  │
  726.        │        A  │       │                    │   │   │ Basic   2   │
  727.        │        T  │       │                    │   │   ├─────────────┤
  728.        │        O  │       │                    │   ├───┤ Build  ALT  │
  729.        │        R  │       │                    │   │   │ C Lang. 3   │
  730.        │           │       │                    │   │   ├─────────────┤
  731.        │           │       │                    │   └───┤ Build  ALT  │
  732.        │  [Alt] O  │       │                    │       │ Pascal  4   │
  733.        └───────────┘       └─────────┬──────────┘       └─────────────┘
  734.                                      │
  735.                                      │  ([Alt] X Key to DOS )
  736.          A>       <──────────────────┘
  737.  
  738.                     S  C  R  E  E N    D  E  B  U  T      1.41    Pg 16
  739.    ──────────────────────────────────────────────────────────────────
  740.  
  741.  
  742.  
  743.  
  744.  
  745.                                SNAP SCREEN
  746.  
  747.  
  748.  
  749.  
  750.   Snap Screen posts to the screen, Screen Debut files. It's primarily
  751.   intended for use with batch files. It's advantage over ANSI is that
  752.   it posts screens very fast. It can reach across a directory or even
  753.   a drive and post a screen in the blink of an eye. All screens can be
  754.   kept in one directory for easy maintenance. It also has the ability
  755.   to post screens in a dramatic split screen way.
  756.    The advantages of using Snap Screen over ".COM" screens are.
  757.    1) Saves Space - It reads Screen Debuts compressed binary files which
  758.       are typical about 800 Bytes in size.  A typical ".COM" screen that
  759.       carries no video assistance takes over 4000 bytes of disk space!
  760.    2) Monitor Support - Snap Screen checks for the type of monitor (color
  761.       or monochrome) and then loads the screen correctly. It also sets the
  762.       DOS prompt to the position you indicate.
  763.    3) Dramatic split screen displays - optional
  764.    4) Ease of Maintenance - All screens can be kept in the directory with
  765.       Screen Debut for easy modification and still used with batch files
  766.       that are located elsewhere.
  767.  
  768.  
  769.   Here's how it works:
  770.  
  771.   A>SNAPSCRN YOURFILE.SD 20 1
  772.  
  773.                  ^        ^ ^
  774.                  │        │ └───(NON Zero = Split Screen, 0 = Normal)
  775.                  │        │
  776.                  │        └─────(UP/DOWN Location of the A> (1 - 24))
  777.                  │
  778.                  └──────────────(File made with Screen Debut        )
  779.                                 (The extension .SD is not necessary )
  780.  
  781.                       S  C  R  E  E N    D  E  B  U  T      1.4     Pg 17
  782.    ──────────────────────────────────────────────────────────────────
  783.  
  784.  
  785.  
  786.                                  ODDS & ENDS
  787.  
  788.  
  789.  
  790.    When developing a screen it is very important to pay attention to
  791.    the hidden color attributes. Changing color attributes for no reason
  792.    adds unnecessary extra code.
  793.  
  794.  
  795.                                  PROGRAM ERRORS
  796.  
  797.  
  798.  
  799.    To the best of my knowledge the program is free, however there's the
  800.    human element. If you find an error, please let me know so I can
  801.    correct it.
  802.    
  803.  
  804.                                ANTICIPATED ERRORS
  805.  
  806.  
  807.  
  808.   Hardware versus Software type errors have been anticipated. An
  809.   example of this type of error is writing to a drive while the drive
  810.   door is open. In  the event of an anticipated error the program will
  811.   try to recover itself. It will beep, give an error message for
  812.   approximately five seconds, then revert to where it was before the
  813.   error occurred. The only action required on your part is to heed the
  814.   error message.
  815.  
  816.  
  817.  
  818.                                MEMORY ALLOCATION
  819.  
  820.  
  821.  
  822.    [ALT] = : This function checks the amount of unused memory. Without
  823.    enough free memory, Screen Debut will crash. In fact, this is the
  824.    only time it's been known to crash. Adding TSR's improperly from the
  825.    DOS shell causes a memory allocation problem. Don't load Screen
  826.    Predator from the DOS shell! If you suspect the program is running
  827.    out of memory check it by pushing "[ALT] =" while in the Main Editing
  828.    environment. Storage of all the large data arrays takes place in the
  829.    Far Memory. Insure that there's plenty of free memory here, as it is
  830.    allocated on the fly. (30KB plus)
  831.  
  832.                      S  C  R  E  E N    D  E  B  U  T      1.41    Pg 18
  833.    ──────────────────────────────────────────────────────────────────
  834.  
  835.                            Limitations
  836.  
  837.     The program will code up to 999 lines of code.
  838.  
  839.    Line 25 has been left off coded screens. Because, when the last
  840.    character of line 25 is written it causes the cursor to move to
  841.    line 26. This causes the screen to scroll.
  842.  
  843.    The ANSI Animator can handle up to 6000 frames. The equivalent
  844.    of three full screens.
  845.  
  846.                               Inquires
  847.  
  848.    Please direct inquires to the fore mentioned address or via the GT
  849.    Network to NET NODE 081/001 (Jack's Board of Augusta Georgia).  Open
  850.    questions concerning ANSI may be directed thru the "International
  851.    ANSI Conference" or the "OZ ANSI Conference" also in the GT net.
  852.    Thanks for taking the time to look this program over!
  853.  
  854.                                             Sincerely,
  855.                                             ╔═════════╗
  856.                                             ║│ │∙││∙┌─╜
  857.                                             ║│││││││├─
  858.                                             ║└┴┘└┴┴┘└─╖
  859.                                             ╚═════════╝
  860.  
  861.                                             Willie Robinson
  862.  
  863.    -------------------------- TRADEMARKS ----------------------------
  864.  
  865.    TURBO C & TURBO Pascal are trademarks of Borland International.
  866.  
  867.    Tandy is a trademark of the Tandy Corporation.
  868.  
  869.    ProBas is a trademark of Hammerly Computer Services.
  870.  
  871.    GT Power is a product of P & M Software Co.
  872.  
  873.